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UNIX Utilities 


The QMS UNIX Host Software supports many varieties of UNIX, including 
the following: AIX Version 4.1, HP-UX Versions 9.x and 10.x, Sun Solaris 


Version 2.5, SunOS Version 4.1.2, SCO Build 10, SGI Version 5.3, and 
SYS V Release 3. 


Use this section for information on: 





“HP-UX Versions 9.x and 10.x” “Setting the Internet Address” 
“QMS qpr Command” “QMS qpr Command” 

“FTP (File Transfer Protocol)” “Password Files” 

“Host Address Files” “Directory Commands” 

“Printer Directories” “Printing and Transferring Files” 
“QMS LPD (Line Printer Daemon)” 
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HP-UX Versions 9.x and 10.x 




















Main Because the QMS UNIX Host Software supports HP-UX Versions 9.x and 
10.x, this section lists the major differences between HP-UX Version 9.x 
CrownNet Setup and HP-UX Version 10.x. For more complete information see Hewlett- 





Packard’s Release Notes for HP-UX 10.x. 











CrownNet Admin. 








@ The minimum memory configuration for Version 10.x is 16 MB. 
Menu Config. 








™ Version 10.x uses a new file system layout based on the industry-stan- 
dard Novell USL and OSF/1 (often called a V.4 file system). 


DOS 








CrownAdmin 3 





In particular, file/directory locations and system startup/shutdown con- 
trol have changed. Source files, shell scripts, binaries, build and test 
CrownView environments, documentation, and environmental variables with 
embedded pathnames may be affected by these file and directory loca- 
tion changes. 
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Print Monitor 











m@ The file system table /etc/checklist is not /etc/fstab. 























UNIX Utilities 
@ The default location for users’ home directories has changed from / 
CrownAdmin 3 users to /home. 
QMS 2060 ™ Version 10 supports the following new HP 9000 computers: Series 800 

















Model K and Series 700 Model J. 
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™ Version 10 supports all Series 700/800 computer’s running Version 9.x 
except the following: 


™ Series 700 (Models 705, 710, 730, and 750) 


™ Series 600/800 (Models 635SV, 645SV, 808, 815, 8225, 8258, 
832S, 8355S, 835SE, 8405S, 8425, 845S, 850S, 8525S, 8555S, 8608, 
865S, 870S/100, 870S/200/300/400) 


@ Any Series 800 with an 8 MB memory card in the first slot. 


@ Version 10.x provides HP Software Distributor, a new tool for installing 


and updating software 


@ In Version 10.01 and later, NFS Diskless replaces Version 9.x’s DUX 


Diskless. Neither NFS Diskless nor DUX Diskless is supported in Ver- 
sion 10.0. 
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Setting the Internet Address 


The printer's Internet (network) address is in the format xxx.xxx.xxx.xxx. It 


must be set, and it must be unique. There are three ways to set the Inter- 
net address: 


m@ The Administration/Communications/Networkx/CrownNet/TCPIP/Inter- 


net Address submenu, explained in Menu Config, “Setting the Internet 
Address” . 


@ The bootp protocol, explained in the following section. “The bootp Pro- 
tocol.” 


@ The rarp protocol, explained later in “The rarp Protocol.” 


The bootp Protocol 


The Bootstrap Protocol (bootp) is an application-level protocol used for 


reading operating environment parameters (such as the Internet address) 
at printer startup. 


1 If necessary, update the system host table by adding the following 
line to the /etc/hosts file: 


internetaddress hostname 
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where internetaddress is the Internet address of the printer and 
hostname Is the name of the host. 


If necessary, update your alias name databases (Yellow Pages and 
YP/NIS). 


Use the cd/var/yp and make commands. 


Add the following single line to the boot table (usually, the /etc/ 
bootptab file) on your host: 


hostname: ht=type: vm=format: ha=hardadd: 
ip=intadd: sm=submask: gw=router 


Use the following table to find the appropriate information with which to 
replace the variables in this line: 











This field... uses this Replace the variable 
variable. with... 
Host Name hostname the name of the host 
ht Hardware Type type the hardware type: 


ether—Ethernet 
token—Token-Ring 


vm Vendor Magic format the bootp report format— 
usually, this should be 
rfcl1048 
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ha Hardware Address | hardadd the printer’s Ethernet or 
Token-Ring address 

ip Internet Address intadd the printer’s Internet 
address 

sm Subnet Mask submask the subnet mask value 

gw Gateway router the default router (gateway) 








address 





4 Start the bootp daemon (if it isn’t already running). Usually, the 


command is 


bootpda 


However, this command is system dependent. Consult your system 


documentation. 


5 Restart the printer to download the Internet address, default router 
(gateway) address, and subnet mask. 


The rarp Protocol 


The Reverse Address Resolution Protocol (rarp) is a low-level transport 
layer protocol that reads the Internet address at printer startup. The follow- 
ing procedure explains how to use rarp to set the printer's Internet 


address: 
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If necessary, update the system host table by adding the following 
line to the /etc/ hosts file: 


internetaddress hostname 


where internetaddress is the Internet address of the printer and 
hostname Is the name of the host. 


If necessary, update your alias name databases (Yellow Pages and 
YP/NIS). 


Use the cd/var/yp and make commands. 


Add the following line to the Ethernet Address table (usually, the / 
etc/ethers file) on your host: 


MMMM INK Me RMI oe Naemest 


where xx: xx:xXX:xXx:xx:xx IS the hardware address of the printer 
and name is the printer name. 


Start the rarp daemon (if it isn't already running). Usually, the com- 
mand is 


rarpd —-al 


QMS 
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However, this command is system dependent. Consult your system 
documentation. 
Main 
5 Restart the printer to read the Internet address. 
CrownNet Setup 
CrownNet Admin. QMS qpr Command 
Menu Config. 
= If you’re printing files over TCP/IP, the QMS qpr command can be used to 
DOS send files to your QMS printer. 
CrownAdmin 3 
os/2 Syntax 
CrownView 








To use the command, type 





Print Utility 





qpr options filed 





Print Monitor 











UNIX Utilities 





where options is replaced by the appropriate options from the following 
table and file is the file you want to print. 
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Options 
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The following options are available for the QMS qpr command. 
Support Info. 











» Note: Not all options are supported by all QMS printers. 
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-#nN Prints n copies of the document. Note that this does not pass the value to 
the spooler as the argument for its copies function. 

-B value Draws a border around the page spot which is value pixels in width. 

-C Enables collation (if supported by your printer) when multiple copies are 
requested. 

-C option Scales the logical page to fit within its page spot. option can be on or off. 

-d Prints the document in duplex mode (if supported by your printer). 

-D string Includes string in the Document Option Command data. 

-f title Changes the title of the document (file) on the header page to title. The 
default title is the name of the file. 

-F left top Specifies the offsets of the logical page within its page spot. Offsets are 
positive or negative displacements from the edges in decipoints ('/720"). 

-g fn cycle Requests that filename fn (a printer-resident file) be compiled and displayed 

unit as the background image of the job. If cycle is “1” the background image 





prints only on the first page of the job. If cycle is “*” the background image is 
repeated for each page of the job. If unitis “sheet” (background image to a 
sheet face) the background job is mapped onto the physical sheet using 
formats specified by the image file. If unit is “page” (background image to a 
logical page), the background job is mapped onto the logical page using 
formats specified by the job. 
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-G col rowsp| Determines the number and size of page spots per sheet (co/is the number 

order of columns per sheet, row is the number of rows per sheet, and spis the 
space between columns), and the logical order in which logical pages 
should be placed within the page spots. 

-h option Turns the header page on or off for the current print job. option can be on or 
off. 

-H source Specifies the input bin to be used for the header page. Bins are the same as 
for 
-l. 

-i type Identifies the physical size of the paper supported by the printer and/or 
controller. tyoe can take the following values: Letter, Legal, Ledger, 
Executive, A5, A4, A3, B5, and B4. 

-| bin Identifies the number of the input bin containing the paper to be used: 1, 2, 

[l is a capital | 3, 4, manualfeed, or “*” (the quotation marks are mandatory). The “*” 

i] requests any available input bin of the specified paper size (-i type) except 
the manual feed tray. 
» Note: Available input bins vary, depending on your printer. 

-K # fold mar| Prints the job in booklet format. # specifies the number of sheets of paper 

thick making up the booklet. fold specifies the direction of the fold (vertical/ 





horizontal). mar specifies the distance between the logical page and the 
fold. thick is the thickness of the paper being used in '/10 mils (in other 
words, in increments of */10,000"). 
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-| language 
[lisa 
lowercase L] 


Specifies the language or emulation (such as hpgl or pcl) to be used by the 
printer to interpret the document. This should correspond to the language 
used in preparing the document. Refer to your printer documentation for 
information on supported languages and emulations. 











CrownNet Setup 














-ls [lis 
lowercase L] 


Invokes landscape orientation. 
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-Mm 


Sends notification via mail(1) when the print job completes. This option is 
passed to the local system spooler, and it is the spooler’s responsibility to 
effect the notification. 
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-M left top rt 


Specifies the margins which encompass all marks printed on a given sheet 
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bot alt for all sheets of a given document. Margins are displacements from the 
edges of the sheets measured in decipoints ('/720"). left is the left margin, 
top is the top margin, rtis the right margin, bot is the bottom margin, and alt 
is the alternate margin. 

-o bin Identifies the number or logical name of the output bin to be used: 1, 2, 3, 
name, or “*” (the quotation marks are mandatory). The “*” requests any 
available face-down output bin. 

» Note: Available output bins vary, depending on your printer. 
-p Invokes portrait orientation. 
-P printer Sends the file(s) to printer. If printer is omitted, the file(s) is sent to the user’s 


default printer as given by the PRINTER environment variable for BSD 
systems or by the system default destination for SYSV systems. 
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-r resolution 





Uses the print resolution or dot density of resolution. Available resolutions 
are product dependent. 
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-R fpage Specifies a range of logical pages to print. You may use “” (the quotation 

lpage marks are mandatory) for joage to indicate the end of the document. The 
default setting is 1 “*” (the quotation marks are mandatory). 

-S type Selects the size of the logical page mapped to the physical sheet of paper to 
be used by the current print job. The values of type are the same as for -i. 

-t Prints the document in tumble duplex mode (if supported by your printer). 

-tr option Turns the trailer page on or off for the current print job. This option can be on 
or off. 

-ts option Specifies the input bin to be used for the trailer page. Bins are the same as 
for -I. This option must be used with -tr. 
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Notes 


m@ The number of copies to be printed and the duplexing parameters may 
be overridden by specifications within the document itself. Refer to your 
printer user's guide for availability of specific features. Also refer to your 
QMS Crown Document Options Commands manual for the correct 
DOC syntax. 


@ The local system spooler, lpr(1) or lp(1), is assumed to reside along the 
invoker's path. 


@ qpr terminates the DOCs it adds to the beginning of the file with the 
command %%EndComments. DOCs that are already coded within a 
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file prior to printing with qpr will not be parsed as DOCs when sent by 
qpr because of this terminating command. 
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prewar Setup FTP (File Transfer Protocol) 














pei alii The usual implementations of FTP are designed to transfer files from host 








Menu Config. to host. The QMS TCP/IP implementation is designed to allow the transfer 
Dos of files from a host to an FTP server in a QMS Crown printer. This makes it 
easy for you to do tasks such as log on the printer, check the number of 

jobs in the print queue, list the available fonts, and send files to the printer. 
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os/2 
While FTP is an interactive program that requires you to log on the printer 

CrownView before sending commands, these commands can be entered into a UNIX 

Print Utility shell script or a PC batch file that executes the commands automatically. 





In this way, a continuous check of the printer job queue, for example, can 
be done by writing a script that loops around the appropriate FTP com- 
UNIX Utilities mands. 








Print Monitor 
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Supported FTP Commands 
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Since several FTP commands are not applicable to a printing environment, 

















Support Info. the QMS implementation supports a printer-related subset of the standard 
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FTP commands. Because requests for information such as job status ora 
list of current fonts are not explicit FTP commands, other methods are 
used to obtain this type of information. These methods are described later 
in this chapter. 


It is important to note that all versions of FTP are not identical. However, 
the following commands are supported by most implementations of FTP, 
including the QMS implementation: 
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Use this to... 

command... 

cd directory change to the specified printer directory 

close terminate the ftp session 

dir list the contents of the current printer directory 

get receive a file from the printer 

help list commands that are currently supported by the FTP server 
Is list the contents of a directory (filenames only) 

mput filenames | send multiple files to the printer 

open open an ftp session on the printer 

put filename send one file to the printer 

pwd display the full pathname or the current printer directory 
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quit exit from FTP 
- type filetype specify whether the system is to interpret print riles as binary as 
me ASCIl data 
CrownNet Setup 





Logging in to a Printer via FTP 








CrownNet Admin. 














When you connect to a QMS Crown printer using FTP, you can interac- 






























































Menu Config. tively request information from the printer as well as send data to the 
DOS printer to be printed or stored. 
CrownAdmin 3 To log in to a printer, type either 
OS/2 ftp printername 
Crono (where printername is the host name of the printer to which you want to 
Print Utility connect) or 
Print Monitor ftp ipaddressl 
UNDE Dulities (where jpadaress is the IP address of the printer to which you want to con- 
nect). 
CrownAdmin 3 
Example 
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The host in this example is identified as unix, and the printer is identified as 
chaucer: 
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[unix, 227] ftp chaucer-— 

Connected to chaucer. 

220 OMS CrownNet Rev x.x 

220 QMS 1725E System; Release 1.1; Firmware 1; Processor 
R3081; CROWN 0; ready. 

Name (chaucer:brian): root 

331 User name ok, need password 

Password: 4 

230 User logged in 

ftp> 





Exiting from a Printer via FTP 


To exit from the printer and close the FTP connection, at the prompt type 


quit 


Note: The close command also allows you to exit from the printer, but FTP remains 
active. 


Example 


ftp> quit 
221 Goodbye 
unix 2] 
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Password Files 


If the printer has a hard disk, you can secure the files on the hard disk 
through the use of passwords. Installing a password file is a three-step 
procedure: 


™ Create the password file 
® Download the password file 
@ Turn the printer off and restart it for the passwords to take effect 


Note: /f you have a security key for your printer, you can set an Administration menu 
password for the special administrative account “root” via the printer control panel. 


Create the Password File 


Create the password file on the local host. The password file must be 
named PASSWD.FTP. The format of the password file is 


accounti:password1 
account2:password2 
account3:password3 


Caution: Since passwords are encrypted, keep the original password file in a 
secure place on the host computer. 
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Download the Password File 


1 


ao Ff © ND 


Make sure the Administration/Communications/Networkx/Crown- 
Net/TCPIP/Secure Files option is disabled. 


See “TCP/IP Menu” in Menu Config, for complete information. 
Make sure the printer's hard disk is configured correctly. 
Log in to the printer as root. 

Type cd admin.! to change to the admin directory. 


Type put password. ftp.! to copy the password file to the admin 
directory on the printer's hard disk. 


Note: /f there is no hard disk or if the hard disk is not correctly configured, the 
following message is displayed: Can not open file on printer. 


Example—lIn this example, the user has already completed steps 1-3 
above. 


ftp> cd admin 

250 Chdir okay 

ftp> put passwd.ftp 

200 PORT command okay 

150 Opening connection 

226 Transfer complete 

local: PASSWD.FTP remote: passwd.ftp 
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37 bytes sent in 0.025 seconds (1.4 Kbytes/s) 
ftp> quit 

221 Goodbye 

unix 5] 


Restart the Printer 


Once you have downloaded the password file, turn the printer off and back 
on again for the passwords to take effect. 


Logging In with a Password 


Once the passwords are in effect, users are prompted for a password 
when they log in to the printer. 


Example—lIncorrect Password 


This example shows what happens when you try to log in with an incorrect 
password (notice that the password does not appear on the screen when 
you type it). The host in this example is identified as unix, and the printer is 
identified as chaucer: 


unix 6] ftp chaucer 
Connected to chaucer. 
220 OMS CrownNet Rev. xX.x 
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220 QMS 1725E System; Release 1.1; Firmware 1; Processor 





R3081; CROWN 0; ready. 














































































































Main Name (chaucer:brian): jess 
331 User name ok, need password 
Password: - 

CrownNet Setup 530 Login failed 
ftp> quit t 
CrownNet Admin. unix 7] 
Menu Config. 
Example—Correct Password 
DOS . ; . 
This example shows what happens when you log in with a correct pass- 
CrownAdmin 3 word (notice that the password does not appear on the screen when you 
os/2 type it). The host in this example is identified as unix, and the printer is 
identified as chaucer: 
CrownView 
: = unix 8] f£tp chaucer 

daca Connected to chaucer. 

Print Monitor 220 QMS CrownNet Rev. x.x 
220 QMS 1725E System; Release 1.1; Firmware 1; Processor 

UNIX Utilities R3081; CROWN 0; ready. 
Name (chaucer:brian): jess 

CrownAdmin 3 331 User name ok, need password 

Password: pal 

QMS 2060 230 user logged in 
ftp> 
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Listing the Contents of the Password File 


Use the UNIX cat command to list the contents of the original 
PASSWD.FTP file on the host system: 


unix 9] cat password. ftp 
jess:newark 
brian:wilmington 

karen: whonoz 

ken: deerfield 
janice:mobile 
melissa:elibom 





Host Address Files 


If your printer has a hard disk, you can ensure that only host computers 
with one of the specified Internet addresses are allowed access to the 


printer through the use of a host address file. Installing a host address file 
is a three-step procedure: 


™ Create the host address file. 
™ Download the host address file to the hard disk. 


@ Turn off and restart the printer for the host addresses to take effect. 
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Create the Host Address File 


Create the host address file on the local host The host address file must be 
named HOST.EQ. The format of the host address file is 


192.009.200.001 
192.009.300.003 
192.009.300.006 





Download the Host Address File 


1 Make sure the Administration|Communications/Networkx/Crown- 
Net/TCPIP/Secure Files option is disabled. 


See “TCP/IP Menu” in Menu Config, for complete information. 


2 Make sure the printer's hard disk is configured correctly (see 
“Identifying Hard Disks,” later in this chapter). 


3 Log in to the printer as root. 


4 Type cd admin. to change to the admin directory. 


5 Type put host .eq-! to copy the host address file to the admin 
directory on the printer's hard disk. 


Note: /f there is no hard disk or if the hard disk is not correctly configured, the 
following message is displayed: Can not open file on printer. 
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Example—lIn this example, the user has already completed steps 1-3 
above. 
Main 
ftp> cd admin 
250 Chdir okay 
CrownNet Setup ftp> put host.eq-! 
- 200 PORT command okay 
CrownNet Admin. 150 Opening connection 
Menu Config. 226 Transfer complete 
local: host.eq remote: host.eg 
DOS 37 bytes sent in 0.025 seconds (1.4 Kbytes/s) 
; ftp> quit 
CrownAdmin 3 591. Goodbye 
OS/2 unix 14] 
CrownView Restart the Printer 
Print Utility Once you have downloaded the host address file, turn the printer off and 
ss back on again for the file to take effect. 
rint Monitor 
UNIX Utilities ee . 
Listing the Contents of the Host Address File 
erownndmins Use the UNIX cat command to list the contents of the original HOST.EQ 
QMS 2060 file on the host system: 
Support Info. unix 16] cat host.eqw 
192.009.200.001 











QMS 
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192.009.300.003 
192.009.300.006 















































Main 
CrownNet Setup Directory Commands 
CrownNet Admin. This section describes the following commands: 
Menu Config. @ pwd—Displays the current (working) directory 
DOS 





™ cd—Changes directories 





hei ed ™ dir—Lists the contents of a directory 
os/2 














CrownView 





Displaying the Current Directory (pwd) 
































Print Utility To determine the current (working) directory, type pwd 
Print Monitor Example 
UNIX Utilities ftp> pwd. 
257 "usr" is the current directory. 
CrownAdmin 3 ftp> 
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Changing Directories (cd) 
To change directories, use the cd command: 


@ Type cd directoryname- to change to a directory with the name direc- 
toryname. 


@ Type cd /.! to return to the printer root directory. 


In both situations, the message 250 CWD command successful dis- 
plays on your monitor. 
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Listing the Contents of a Directory (dir) 
To list the contents of a directory, type dirt 


Example—This example lists the directories available in the printer's root 
directory. The following sections of this chapter describe these printer 
directories in more detail. 


ftp> dir 

200 PORT command successful 

150 Opening data connection for dir 
(161.33.128.1.7.107) (0 bytes), (mode ascii. 





admin 

disk 

help 
no_doc_cmds 
usr 


226 Transfer complete. 
28 bytes received in 0.01 seconds (2.7 Kbytes/s) 
ftp> 
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Printer Directories 
The following printer directories are available. 


» Note: Putting a file to any directory other than ADMIN, DISK, and USR causes the file 
to print. 


ADMIN Directory 


Only users logged in as root have access to this directory. The HOST.EQ 
and PASSWD.FTP files are stored in this directory. 


You can put files to or get files from this directory. To get a file, you must 
know the filename in advance. 


» Note: Typing dir in this directory produces the error message invalid dir 
command. 


DISK Directory 


Only users logged in as root have access to this directory. The printer’s 
hard disk(s) are accessed through this directory. 


You can put files to or get files from any physical subdirectory. The com- 
plete pathname must be specified. 
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Note: Typing dir in this directory produces the error message invalid dir 
command. 


HELP Directory 


After changing to this directory (cd help), type dir to list the com- 
mands supported by the server. 

Note: This list differs according to whether you are logged in with or without “root” 
privileges. 

putting a file to this directory causes the file to print. On the printed file’s 
header page and in the JOBS directory under Remote Console, the file- 


name is displayed in the %%Title: field, and your FTP logon name is used 
in the %%For: field. 


NO_DOC_CMDS Directory 


putting a file to this directory causes the file to print. On the printed file’s 
header page and in the JOBS directory under Remote Console, the file- 


name is displayed in the “Title:” field, and your FTP logon name is used in 
the “For:” field. 


The QMS Document Option Commands (DOC) %%Title and %%For 
override the default “Title:” and “For:” fields. However, FTP printing 
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requires that jobs using %%Title and %%For commands be put to the 
printer interface’s NO. DOC CMDS directory. If jobs are put to any other 
directory, these commands are ignored. (See the QMS Document Option 
Commands manual for more information about DOCs.) 


In the two examples below, the user (scottc) has included the following 


DOCs at the beginning of the file SCOTTC.TXT, which is put to two differ- 
ent printer directories: 


%! 

%% Title: Scottc Title 

%%For: Scottc For 

%%Routing: Scottc Routing 
%%olncludeF eature :header(on)trailer(off) 


%%End Comments 


Example 1—In this example, the user (scottc) puts the file SCOTTC.TXT 
to a printer directory other than NO_DOC_CMDS: 


ftp> put scottc.txt 

200 PORT command successful 

150 Opening data connection for scottc.txt 
(161.33.128.1.7.107), (mode ascii. 
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226 Transfer complete 
local:scottc.txt remote: scottc.txt 




















Main 10457 bytes sent in 0.009 seconds 
(1. le+02 Kboytes/s) 
ftp> 
CrownNet Setup 











When the job is printed, the following information is included on the header 
page. Notice that the default job owner (the name under which the user 
Menu Config. logged in: scottc) and the default job title (scottc.txt) are used. The 

DOS %%Title and %%For DOCs are ignored, but the %%Routing DOC is 
interpreted correctly. 








CrownNet Admin. 




















CrownAdmin 3 


os/2 Example 2—In this example, the user (scottc) puts the file SCOTTC.TXT 
to the NO_DOC_CMDS directory: 














CrownView 





ftp> cd no_doc_cmds.- 

Print Utility 250 CWD command successful. 

ftp> put scottc.txt 

200 PORT command successful. 

UNIX Utilities 150 Opening data connection for scottc.txt 
(161.33.128.1.7.107), (mode ascii. 
226 Transfer complete 
local:scottc.txt remote: scottc.txt 
QMS 2060 10457 bytes sent in 0.04 seconds 
(2.6e+02 Kbytes/s) 

Support Info. ftp> 
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When the job is printed, the following information is included on the header 
page. Notice that the information given in the %%For and %%Title DOCs 
overrides the default job owner and job title. 


emulation 

JOB # 

Scottc Title 

For: Scottc For 
Routing: Scottc Routing 


Submit queue:Ethernet 
Submitted 0:36:32 
Started: 0:36:32 


USR Directory 


» 


You can put files to or get files from this directory. To get a file, you must 
know the filename in advance. 


Note: Typing dir in this directory produces the error message invalid dir 
command 
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Printing and Transferring Files 


Four commands—type, put, mput, and get—allow you to work with 
printer files. 


type Command 


The type command allows you to check or set the file transfer mode. Its 
function depends on whether or not you include a filetype after the com- 























mand: 
Syntax type 
Purpose Checks the current filetype 
Syntax type filetype 
Purpose Sets the type of data contained in the file to be put (sent) to the printer. 
filetype binary—For 7-bit or 8-bit binary data 

ascii—For other data 

Notes This command changes the way the host sends data, not how the 





interface receives the data. From the host's point of view, the primary 
difference between binary and ASCII files is the way carriage returns 
and line feeds (<CR> and <LF>) are handled 

Binary—<CR>=<CR> and <LF>=<LF> 

ASCII—<CR>=<CR>+<LF> and <LF>=<LF>+<CR> 
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Example—lIn this example the type command changes the transfer mode 
to binary: 

Main 
ftp> type binary 
200 Type set to I 
CrownNet Setup ftp> 
CrownNet Admin. 
put and mput Commands 
Menu Config. 
DOS The put command allows you to send a file to the printer for printing or 
storage. The mput command allows you to send multiple files to the 
wean printer for printing or storage. 
OS/2 
Syntax put filename 
CrownView mput filenames 
: = Purpose _ | put sends a file to the printer or downloads the file to the printer’s hard 
Print Utility disk. 
Print Monitor mput sends several files to the printer or downloads several files to the 
UNIX Utilities printer’s hard disk. 
CrownAdmin 3 
QMS 2060 
Support Info. 
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filename | The filename(s). If the files are not in the host’s root directory, use the full 
pathname. Wildcards are acceptable with the mput command. 
ical Notes You can use the put or mput command in any directory. However, to put 
or mput files to a hard disk, you must be in the ADMIN, DISK, or USR 
CrownNet Setup directory. (If you are not already in the directory, the file prints.) 
Only users with “root” privileges can put or mput files to the ADMIN and 
CrownNet Admin. DISK directories. The ADMIN directory assumes that the path is SYS:/ 
ADMIN), but you must change to the USR directory before you can put or 
Menu Contig. mput files there: 
DOS ftp> put filename SYS:/usr/files/filename-| 
If you attempt to put or mput files to the printer while the printer is off line, 
CrownAdmin 3 you are told that the printer is off line, and then FTP waits until the printer 
is placed back on line to send the file(s). 
OS/2 
Ceowhview Example—In this example all of the files in the current directory are mput 
(sent) to the printer: 
Print Utility 
ftp> mput *.*W 
Print Monitor mput file.ext? y-l 
UNIX Utilities 200 Pere se Oue ne SHeESS Stuy 
150 Opening data connection for file.ext 
- (161.33.128.1.7.107), (mode binary). 
CrownAdmin 3 226 Transfer complete 
mput file2.ext? yA 
aie sts? 200 PORT command successful 
Support Info. J5U Opening data connection. for. fiié.ext 




















(161.33.128.1.7.107), (mode binary). 
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local file2.ext remote: file2.ext 
226 Transfer complete. 
























































































































































Main 10457 bytes sent in 0.04 seconds 
(2.6e+02 Kbytes/s) 
ftp> 
CrownNet Setup 
CrownNet Admin. get Command 
Menu Config. The get command allows you to transfer files from the printer to the host. 
oS Syntax get filename 
CrownAdmin 3 Purpose Transfers files from the printer’s hard disk to the host. 
Os/2 filename The name of the file as it appears on the printer’s hard disk. If the file is 
not in the host’s root directory, use the full pathname. 
CrownView Notes If the current directory is ADMIN, only users with “root” privileges can get 
Print Utilit files. The USR directory assumes that the path is DSK7:/USR, DSK6:/ 
: USR, or DSK5:/USR (whichever is applicable.) However, if you are in the 
Print Monitor DISK directory, you must give the entire path for filename. For example, 
ftp> get SYS:/admin/passwd.ftp password. 
UNIX Utilities 
Example—This example shows how to get (transfer) filename from the 
CrownAdmin 3 printer to the host: 
QMS 2060 ftp> get file3.ext 
200 PORT command successful 
Support Info. 150 Opening data connection for file.ext 


QMS 











36 of 41 
(161.33.128.1.7.107), (mode binary). 
local file3.ext remote: file3.ext 
Main 226 Transfer complete. 














10457 bytes sent in 0.04 secondsd 
(2.6e+02 Kbytes/s) 
































CrownNet Setup ftp> 
CrownNet Admin. 
Menu Config. 
DOs QMS LPD (Line Printer Daemon) 








CrownAdmin 3 








The QMS LPD (Line Printer Daemon) allows your printer to appear as a 
remote UNIX print system to all supported BSD LPD-capable systems. 


aac The Berkeley remote print system is supported by many hosts and is easy 
eeeee to configure. It must be RFC 1179 compliant. 


OS/2 
































ical » Note: The QMS LPD does not support any of the optional command line parameters 
Print Monitor used by Ip or lpr. 
UNIX Utilities 








Configuring the Host to Use the QMS LPD 


Before you can use the QMS LPD to provide print job spooling, you must 
make the following configuration changes on the host: 
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™ Modify the TCP/IP host table in the host's /etc/hosts file. 
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@ Modify the printer’s entry in the host's /etc/printcap file. 


Note: Some systems do not use /etc/printcap for configuration. See your UNIX system 
documentation for the equivalent commands. 


Modifying the TCP/IP Host Table 


The TCP/IP host table on the BSD system is found in the /etc/hosts file. 
You must modify this table to associate the printer’s Internet address with 
its TCP/IP network node name. 


Note: The printer’s Internet address is set in the Administration/Communications/ 
Networkx/CrownNet/TCP!/P/Internet Address menu. (See “TCP/IP Menu” in Menu 
Contig, for more information.) 

For example, if the printer's Internet address is 192.009.200.140 and its 
TCP/IP network node name is “qms,” you would add the following line to 
the /etc/hosts file: 


192.9.200.140 gms 





Note: For systems running the Domain Name Service (DNS), this Internet address/ 
node name pairing should also be added to the DNS administrative database files. 
(See your UNIX documentation for more information.) 








Main 

















CrownNet Setup 














CrownNet Admin. 








Menu Config. 








DOS 








CrownAdmin 3 








OS/2 








CrownView 








Print Utility 








Print Monitor 














UNIX Utilities 











CrownAdmin 3 











QMS 2060 

















Support Info. 











38 of 41 


Modifying the Printcap Entry 


The printer capability file is /etc/printcap. The UNIX Ipr command looks for 
this file each time a print request is made. Therefore, there must be an 
entry in this file corresponding to the printer's TCP/IP network node name 
in the TCP/IP host table. For example, if you use the same node name as 
in the previous example, “qms,” you would add the following entry to the / 
etc/printcap file. 


QMS|QMS Printer: \ 
:lp=:\ 
:sd=/usr/spool/anyqueue: \ 
:rm=qms: \ 
: rp=anyqueue 


In this entry, QMS is the host queue name, Ip specifies the device to which 
you are printing (it is undefined here since you are printing remotely), sd 
stands for “spool directory,” qms is the name of the printer (rm stands for 
“remote machine”) in the host’s TCP/IP host table (identified in the previ- 
ous section), and anyqueue is the printer queue name (rp stands for 
“remote printer”). 
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Using LPD 
Once you have modified the necessary host files, you can use the UNIX 
lpr command to print a file (and take advantage of the QMS LPD): 


lor -PQMS filename 


“QMS” is the host queue name you specified in the /etc/printcap file. If the 


-P option is not used, Ipr uses the printer specified in the PRINTER envi- 
ronment variable or the default Ip. 


The QMS LPD observes the spooling options (Spooling On, Spooling On 
Input Idle, and Spooling On Idle) currently set in the Administration/Com- 
munications/Networkx/CrownNet/Common/Spooling printer menu. 


Monitoring Status 
Using LPC 


LPC is a UNIX utility that allow the system administrator to enter several 
UNIX printer control commands through a single command. After you add 
the QMS queue to the /etc/printcap file, the UNIX command 


lpec statusa 
should return the following message: 
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QMS: 
queueing is enabled 
printing is enabled 
no entries 
no daemon present 


Using LPQ 


The UNIX Ipq command requests a job queue display similar to the follow- 
ing: 

Printer Status:NO ERROR 

Job #QueueTitleUserI/F Status 
12 QMS chapl.psBrianEthernetSpooling 0 of 0 
13 QMS pix.psJessEthernetPrinting 1 of 1 
Notice that the Queue name reported is the name you defined in the rp 
field in the host’s /etc/printcap file. 

















If no jobs exist in the queue, the following message displays: 


Printer Status:NO ERROR 


or 








Printer Status:IDLE 
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In the event of an error on the printer, the NO ERROR message in the 
Printer Status field is replaced with the same message displayed in the 
printer's control panel message window. 


